home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 21 / AACD 21.iso / AACD / Utilities / Help / locale / help / english / sys / requestchoice.doc < prev    next >
Encoding:
Text File  |  2000-10-06  |  1.1 KB  |  42 lines
  1. REQUESTCHOICE
  2.  
  3. Allows AmigaDOS and ARexx scripts to use custom requesters.
  4.  
  5. Format
  6.  
  7. REQUESTCHOICE >TITLE> <body> {<gadgets>} [PUBSCREEN <public screen name>]
  8.  
  9. Template
  10.  
  11. TITLE/A,BODY/A,GADGETS/A/M,PUBSCREEN/K
  12.  
  13. Location
  14.  
  15. C:
  16.  
  17. The <title> argument specifies the title of the requester.
  18.  
  19. The <body> argument specifies the text of the requester. Linefeeds can be
  20. embedded using *N.
  21.  
  22. The <gadgets> argument specifies the text for the different gadgets. The
  23. gadget labels are separated with spaces.
  24.  
  25. The number of the selected gadget is printed as a result to the console. For
  26. evaluation in a script file, you can redirect this output into an environment
  27. variable. If the requester cannot be opened, the command generates a return
  28. code of 20.
  29.  
  30. The PUBSCREEN argument allows the requester to open its window on a public
  31. screen.
  32.  
  33. Example:
  34.  
  35. 1> RequestChoice >ENV:rcnum "New Title" "This is my requester*nSelect a
  36. gadget" "OK" "Maybe" "Cancel"
  37.  
  38. Figure 6-1. Sample RequestChoice Requester
  39.  
  40. ENV:rcnum contains 0, 1, or 2 after a gadget is selected. The script can use
  41. this value to control its later execution.
  42.